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Abstract 


The  Software  Engineering  Institute  (SEIsm)  was  called  on  recently  to  examine  a  system, 
hereafter  called  SYS,  written  entirely  in  the  Tool  Control  Language/Toolkit  (Tcl/Tk)  language. 
In  response  to  some  negative  comments  in  the  SEI’s  report,  the  developers  presented  a  list  of 
systems  purported  to  demonstrate  the  viability  of  Tcl/Tk  as  a  development  tool.  A  review  of 
the  67  listed  systems  found  that  Tcl/Tk  is  indeed  practical  for  developing  large  systems. 

Small  systems  written  in  the  language  often  follow  a  paradigm  of  “classic  Tcl/Tk  windows.” 
STS  embraced  this  approach  to  the  extent  of  involving  hundreds  of  windows.  The  review 
showed  that  no  other  large  system  written  in  Tcl/Tk  has  anywhere  near  as  many  such 
windows.  User  interviews  suggested  that  the  number  of  different  windows  was  indeed  a 
problem.  SI'S  should  consider  an  alternative  design,  perhaps  a  Web-based  approach.  Some 
design  criteria  are  described  at  the  end  of  the  report. 


SM  SEI  is  a  service  mark  of  Carnegie  Mellon  University. 
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1  On  the  Suitability  of  Tcl/Tk  for  SYS 


Recently,  I  was  part  of  a  team  reviewing  a  Department  of  Defense  (DoD)  program  that  we 
can  call  “SYS.  ”  This  system  is  written  almost  entirely  in  Tcl/Tk  (Tool  Control 
Language/Toolkit,  pronounced  “tickle-tee-kay”).  While  Tcl/Tk  is  an  unconventional  choice 
for  DoD  systems,  it  is  not  necessarily  a  bad  choice.  Nonetheless,  as  part  of  our  review,  we  did 
recommend  that  another  approach  be  taken  for  the  developmental  work  planned  to  supplant 
additional  legacy  systems.  The  development  team  was  not  completely  sympathetic  to  our 
suggestion;  they  referred  us  to  several  Web  sites  proffering  evidence  that  Tcl/Tk  is  a  widely 
used  platform  for  commercial  systems.  This  note  reviews  those  Web  sites  and  goes  on  to 
consider  a  number  of  other  factors  that  should  influence  the  choice  of  Tcl/Tk  as  a  tool  for 
further  development  of  SYS. 

At  the  outset,  it  is  important  to  make  two  points: 

•  This  note  does  NOT  suggest  that  Tcl/Tk  is  a  “bad”  environment.  On  the  contrary,  the 
Web  review  shows  the  utility  of  Tcl/Tk  for  numerous  purposes. 

•  This  note  does  not  suggest  that  Tcl/Tk  was  a  “bad”  choice  for  the  current  SYS 
functionality.  SYS  works.  It  is  a  fielded  system  that  daily  satisfies  the  needs  of  hundreds 
of  users. 

The  question  that  this  note  does  address  is  whether  to  continue  further  development  of  SYS 
with  its  current  choices  for  user  interface  architecture  and  system  architecture.  These 
architectural  questions  are  far  more  critical  to  success  than  the  programming 
language/environment. 
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2  The  Design  of  Tcl/Tk 


Tel  was  designed  as  a  control  language:  a  language  in  which  a  programmer  could  quickly 
write  scripts  to  invoke  diverse  operations — often  operations  written  in  another  language.  In 
common  with  other  interpretive  languages,  Tel  was  designed  for  rapid  code-test  cycles.  The 
Frequently-Asked-Questions  (FAQ)  posting  for  Tcl/Tk  [Virden  2002]  describes  the  language 
this  way: 

Tel  is  actually  two  things:  a  language  and  a  library.  First,  Tel  is  a  simple 
textual  language,  intended  primarily  for  issuing  commands  to  interactive 
programs  such  as  text  editors,  debuggers,  illustrators,  and  shells.  It  has  a 
simple  syntax  and  is  also  programmable,  soTcl  users  can  write  command 
procedures  to  provide  more  powerful  commands  than  those  in  the  built-in  set. 

Second,  Tel  is  a  library  package  that  can  be  embedded  in  application  programs.  The  Tel 
library  consists  of  a  parser  for  the  Tel  language,  routines  to  implement  the  Tel  built-in 
commands,  and  procedures  that  allow  each  application  to  extend  Tel  with  additional 
commands  specific  to  that  application.  The  application  program  generates  Tel  commands 
and  passes  them  to  the  Tel  parser  for  execution.  Commands  may  be  generated  by  reading 
characters  from  an  input  source,  or  by  associating  command  strings  with  elements  of  the 
application's  user  interface,  such  as  menu  entries,  buttons,  or  keystrokes. 

Tcl/Tk  was  designed  with  scripting  as  its  specific  area  of  functionality.  As  the  FAQ  goes  on  to 
say. 

Note  that  Tel  was  designed  with  the  philosophy  that  one  should  actually  use  two  or  more 
languages  when  designing  large  software  systems.  One  for  manipulating  complex  internal 
data  structures,  or  where  performance  is  key,  and  another,  such  as  Tel,  for  writing  smallish 
scripts  that  tie  together  the  other  pieces,  providing  hooks  for  the  user  to  extend. 

Early  in  its  career,  Tel  was  extended  with  Tk,  a  Toolkit  of  widgets  suitable  for  making 
graphical  user  interfaces  (GUIs).  Examples  of  applications  using  these  widgets  can  be  found 
at  incrtcl.sourceforge.net/itcl/mmc/full/electric.gif.  One  example  follows: 
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Delete 


Add 


jrstaff:  allegra  aJex  max  Katie 
tclconsortium:  mmc  peter  emily 
tcltk:  mmc  gah  Ifb  Idr 


Group  Name: 
Group  Members: 


Apply 

Cancel  |  j 

i _ _ _ ~ _ -= — ^ 

Figure  1 :  Electronic  Secretary:  Preferences 


Here  each  box  is  a  separate  Tk  widget.  There  are  labels  (“Group  name”),  text  entry  fields  (to 
the  right  of  the  labels),  buttons  (“Add”),  a  panel  (contains  two  bottom  buttons),  a  list 
(“jrstaff...”),  a  scrollbar  (to  the  right  of  the  list),  and  file  tabs  (“Colors”).  When  a  button  is 
clicked,  the  usual  implementation  is  that  a  Tel  procedure  is  called.  It  usually  changes  the 
window  or  opens  a  new  one. 


Tk  was  developed  just  as  X  Windows  was  developing  the  sets  of  screen  widgets  that  Tk 
employs  to  draw  on  the  screen.  Since  it  was  one  of  the  few  easy  ways  to  build  prototypes 
with  X  widgets,  Tcl/Tk  became  popular  early  on.  The  existence  of  Tk  is  one  factor  that 
distinguishes  Tel  from  other  scripting  languages  such  as  Python  and  Perl.  The  Tk  widget  set 
is  quite  similar  in  capabilities  to  the  sets  supported  in  Motif,  HTML,  Visual  Basic,  Java,  and 
most  GUI  builder  tools. 
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3  Classic  Tcl/Tk  Windows 


Based  on  Tel  convenience  and  the  Tk  widgets  there  arose  a  class  of  programs  implemented  as 
“classic  Tcl/Tk  windows.”  In  the  paradigm  followed  by  these  programs,  the  program  opens  a 
window,  populates  it  with  widgets,  and  interacts  with  the  user  by  responding  to  actions  on 
those  widgets.  Very  often  the  application  has  a  number  of  such  classic  windows;  clicks  on 
some  buttons  may  change  the  window  or  create  a  new  one. 

In  this  classic  Tcl/Tk  window  paradigm,  when  a  new  set  of  data  is  to  be  displayed,  a  new 
classic  window  pops  up.  When  a  decision  is  required  from  the  user,  a  separate  “dialog  box” 
window  is  popped  up  wherein  the  choice  can  be  made,  usually  by  clicking  a  widget.  Since 
classic  Tcl/Tk  windows  generally  do  not  scroll  the  entire  window,  they  must  survive  in 
constrained  screen  space.  In  consequence,  there  is  a  tradition  of  cryptic  button  labels.  Image 
tools  are  few,  so  icons  are  seldom  developed.  Altogether,  the  window  image  for  a  classic 
Tcl/Tk  window  is  functional,  but  not  always  inviting. 

In  programs  with  classic  Tcl/Tk  windows,  the  usual  software  architecture  is  one  Tel  source 
file  per  window.  There  is  seldom  any  further  program  structure  to  subdivide  functionality  or 
relate  windows  to  clusters  of  functionality.  The  user  interface  architecture  is  a  branching  tree 
of  windows.  For  small  trees,  this  is  great;  with  experience  a  user  can  easily  navigate  through 
the  tree  to  get  what  is  needed.  Navigation  problems  arise,  as  noted  below,  when  the  number 
of  windows  grows  large.  This  is  an  example  of  a  technological  boon  morphing  into  a  liability. 
Similar  user  interfaces  can  be  implemented  almost  as  easily  with  other  languages,  but  their 
programming  becomes  more  onerous  as  the  size  grows.  Tcl/Tk  continues  to  offer 
programming  simplicity  even  after  the  user  interface  has  begun  to  degrade. 
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4  SYS  Overview 


The  system  architecture  of  SYS  connects  user  workstations  across  a  local-area  network  to 
application  servers.  These  in  turn  are  connected  via  a  wide-area  network  to  remote  database 
servers: 

Work  Application  Database 

station  Server  Server 

X  display 
^protocol^ 

EM 

X  Windows  typical 

server  Tcl/Tk  database 

Figure  2:  SYS  Workstation/Server  Connections 

The  application  server  is  a  Unix  box  and  runs  the  Tcl/Tk  application.  The  application  sends 
commands  in  the  X  Windows  protocol  to  the  user’s  workstation  where  an  X  Windows  server 
program  converts  them  to  screen  images  and  then  relays  user  actions  back  to  the  application. 
On  the  other  side,  the  application  server  converses  in  SQL  with  a  typical  database. 


4.1  User  Interface  Architecture 

The  SYS  user  interface  architecture  is  that  of  a  collection  of  classic  Tcl/Tk  windows.  The  user 
interface  is  a  large  set  of  windows — over  two  hundred.  Each  window  is  a  set  of  widgets,  in  a 
few  shades  of  blue  and  gray,  with  rare  images  and  only  occasional  flashes  of  color.  Users 
click  buttons  to  progress  from  window  to  window  through  the  hierarchy.  While  this  sounds 
simple,  there  are  several  problems: 

•  Hierarchies  this  large  impede  use  more  than  do  the  small  trees  typically  found  with 
classic  Tcl/Tk  windows. 

•  Users  become  lost,  without  sufficient  cues  as  to  how  to  return  to  a  window  that  will 
lead  them  forward  on  a  particular  errand. 

•  As  the  system  grows,  it  becomes  ever  harder  to  remember  which  subtree  contains  a 
needed  functionality  and  unused  portions  of  the  tree  fade  from  memory. 

•  A  proliferation  of  windows  on  the  screen  requires  tricky  manual  management  of 
physical  screen  space  and  mental  recall  of  the  purpose  of  each  window. 

In  interviews  we  conducted  as  part  of  our  review,  users  expressed  various  reactions  to  the 
SYS  user  interface.  Many  comments  were  positive.  Despite  the  fact  that  the  screen  image  of 
reports  is  just  a  rectangular  array  of  fixed-width  text,  it  does  provide  users  the  information 
they  need  with  a  minimum  of  extraneous  matter.  The  screen  size  limitation  is  circumvented 
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for  reports  by  scrolling  within  the  text  panel  holding  the  report  (as  opposed  to  scrolling  the 
entire  image  as  would  happen  with  a  Web  browser). 

Negative  comments,  however,  suggested  that  users  get  lost  navigating  through  the  plenitude 
of  options  the  system  provides.  They  said  things  like  “I  don’t  know  what  report  to  run  to  get 
the  data  I  need,”  and,  “Whenever  I  venture  out  of  the  parts  of  STS  I  usually  use,  I  have  to 
review  the  manual  to  be  able  to  do  the  work.”  In  reviews  of  many  projects,  this  usage 
difficulty  is  reported  as  a  need  for  “more  and  better  training.”  Training  will  help,  but  it  cannot 
forever  paper  over  the  design  deficiencies.  Nor  will  it  help  when  dozens  of  new  users  are 
pressed  into  service  in  a  time  of  emergency,  the  one  time  when  SYS  most  needs  to  be 
functioning  reliably. 


4.2  Software  Architecture 

The  software  architecture  of  SYS  is  also  that  of  a  collection  of  classic  Tcl/Tk  windows.  For 
most  windows  a  single  Tel  module  draws  the  window  and  responds  to  user  actions  on  that 
window.  The  source  code  intertwines  database  access,  business  rules,  and  GUI.  The  result  is  a 
“brittle”  system,  one  that  is  difficult  to  modify  without  unintended  side  effects.  Changing  the 
user  interface  may  cause  unexpected  changes  in  business  rules,  and  vice  versa.  Revisions  to 
the  database  schema  may  require  revising  dozens  of  modules  that  intersect  with  the  changes. 

The  code  is  not  entirely  Tcl/Tk.  Some  of  the  application  is  written  in  SQL  and  stored  on  the 
database  server.  These  procedures  are  executed  based  on  various  sorts  of  data  accesses  and 
revisions.  In  our  review,  we  did  not  cover  sufficient  detail  to  determine  whether  a  clear 
architectural  distinction  is  made  between  Tel  code  and  SQL  code.  It  is  this  author’s 
impression,  however,  that  decisions  to  use  SQL  were  based  on  ad  hoc  criteria.  If  so,  the 
separation  offers  no  architectural  clues  that  will  aid  in  program  revision. 


4.3  With  All  These  Problems,  How  Can  SYS  Be  Working? 

For  both  the  user  interface  and  system  architectures,  SYS  has  serious  problems.  Why  then  is 
the  system  in  successful  everyday  use?  There  are  a  number  of  reasons: 

•  Users  have  undergone  extensive  training.  This  has  minimized  the  navigation  problems. 

•  Each  user’s  specific  job  encounters  only  a  small  subset  of  the  full  SYS  functionality. 

•  The  system  is  new  and  has  not  undergone  business  rule  changes.  Structural  deficiencies 
are  not  yet  apparent. 

In  other  words,  SYS  is  working  at  its  present  level.  The  problems  noted  above  will  become 
more  burdensome  as  the  system  grows  to  encompass  new  functionality  and  its  code  is  revised 
to  deal  with  changes  to  business  rules,  database  design,  or  user  interface. 


6 


CMU/SEI-2003-TN-001 


4.4  Legacy  Systems 

SYS  is  not  now  complete.  The  system  it  replaced  interfaced  with  a  dozen  other  systems,  all  of 
which  are  antiquated  and  difficult  to  maintain.  Plans  call  for  them  all  to  be  incorporated  into 
the  SYS  framework.  In  some  cases  this  will  mean  that  a  button  click  in  SYS  will  launch 
another  application.  In  most  cases,  however,  the  existing  functionality  is  to  be  recast  in  a  new 
user  interface,  possibly  incorporating  revised  business  processes.  Extending  the  current  SYS 
architecture  will  present  problems  in  managing  the  development  of  extensions,  maintaining 
the  extended  system,  and  in  using  the  system  without  considerable  training  and  handholding. 

The  existence  of  these  legacy  systems  is  the  imperative  driving  the  need  for  flexibility  and 
extensibility  in  the  design  of  SYS.  The  problems  explored  above  will  make  it  difficult  to 
extend  the  existing  SYS  to  encompass  these  legacy  systems. 


4.5  JSYS— Progenitor  of  SYS 

The  SYS  database  augments  the  data  in  JSYS,  a  database  maintained  by  a  parent  organization. 
Before  SYS  was  released,  many  of  its  current  users  interacted  directly  with  JSYS,  so  that 
system  was  an  excellent  model  to  follow  in  the  design  of  SYS.  Copying  the  system 
architecture — JSYS  is  itself  a  collection  of  classic  Tcl/Tk  windows — meant  that  about  a  third 
of  the  JSYS  code  could  be  re-used  in  SYS.1  Copying  the  user  interface  meant  increased  user 
acceptance  and  decreased  training  effort.  Indeed,  our  interviews  of  users  elicited  favorable 
comments  about  the  similarity  of  the  two  user  interfaces. 

Over  time,  however,  the  value  of  JSYS  as  a  model  has  faded.  The  operational  environment  is 
such  that  users  should  work  exclusively  through  SYS  because  it  enforces  the  right  set  of 
business  rules  for  its  users.  When  the  users  no  longer  encounter  JSYS,  there  is  no  longer  any 
merit  in  following  it  as  a  model.  Presently,  plans  for  revision  of  JSYS  may  well  be  in 
progress,  although  nothing  has  been  announced.  Any  change  to  JSYS  could  move  it  away 
from  SYS.  In  addition,  there  is  more  pressure  on  SYS  to  supplant  legacy  systems.  JSYS  may 
not  need  to  reconsider  its  architecture  to  evolve,  but  SYS  must. 


1  Among  the  advantages  is  increased  reliability.  As  the  SYS  developers  work  with  the  JSYS  code  they 
sometimes  discover  and  fix  deficiencies  that  might  otherwise  have  caused  problems.  The  JSYS 
developers  are  occasionally  able  to  return  the  favor. 
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5  Tcl/Tk  in  Commercial  Systems 


In  support  of  the  continued  use  of  Tcl/Tk  on  the  SYS  project,  a  consultant  and  the 
development  manager  sent  references  to  Web  sites  listing  Tcl/Tk  projects  in  commercial  use. 
I  have  reviewed  the  listed  systems,  with  the  results  shown  in  the  Appendix  and  the  Type 
codes  listed  in  Table  1.  After  eliminating  duplicates,  some  67  systems  remain.  Of  these, 
sixteen  (marked  defunct )  no  longer  have  a  detectable  presence  on  the  Web2  and  nine  (marked 
dist)  are  distributions  of  Tcl/Tk  rather  than  applications. 


One  system,  AOLserver,  appeared  on  several  of  the  lists.  It  merits  a  closer  look.  A 
presentation  by  Jim  Davidson  describes  the  adaptations  they  made  toTcl,  the  architectures 
they  used,  and  a  few  examples  [Davidson  2000].  One  example,  the  Digital  City  Movie  Guide, 
might  appear  to  a  user  like  this: 


Top  Ten  Clicks 


Figure  3:  AOL  Digital  City  Movie  Guide 


As  shown  for  a  user  in  Austin,  Movie  Guide  offers  a  synopsis  of  a  movie,  ratings  by 
members,  and  the  times  the  movie  is  showing  at  Austin  theaters.  Among  other  features, 
another  page  shows  the  ‘Top  Ten”  movies  that  have  been  clicked  on  “recently”  by  other  AOL 
users. 


2  That  so  many  listed  systems  are  defunct  need  not  indict  Tcl/Tk.  The  lists  include  systems  five  and 
more  years  old,  a  time  frame  in  which  most  systems  become  defunct.  Rather,  the  invalid  references 
suggest  that  the  lists  are  passe  because  those  who  would  be  swayed  have  been  already  and  those 
who  would  not  are  already  committed  to  other  tools. 
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Type  #  Description 


web 

envt 


These  systems  are  environments  that  create  Web  sites.  Each  has  been  used  as  the 
g  basis  for  multiple  Web  sites  by  multiple  different  customers.  In  general,  these 

systems  generate  HTML  to  create  pages;  that  is,  they  do  not  use  Tk,  except  possibly 
for  a  central  control  console. 


web 

app 


These  are  Web  sites  where  page  generation  is  coded  in  Tel.  The  code  generates 
8  HTML  and  uses  Tk,  if  at  all,  only  for  a  control  console.  Unlike  the  Web  envt 
category,  these  systems  generally  are  used  for  only  one  Web  site. 


These  applications  appear  to  the  user  as  a  small  number  (say  under  two  dozen)  of 
classic  Tcl/Tk  windows,  although  the  number  of  lines  of  code  is  not  necessarily 
small  8  small.  Several  of  these  systems  are  targeted  at  developers,  who  will  appreciate  the 
opportunity  to  revise  them.  There  were  NO  corresponding  systems  with  large 
numbers  of  classic  windows. 


Two  of  these  entries  are  statements  to  the  effect  that  one  or  more  people  use  Tcl/Tk 
frequently;  they  use  it  as  the  hacking  language  of  choice  for  whatever  tasks  arise. 
other  3  This  is  commercial  use  of  Tel,  but  does  not  result  in  deployed  applications.  The 
third  system,  NBC’s  digital  broadcast  control  system,  has  had  its  operational  code 
ported  to  C++;  it  is  no  longer  strictly  Tel. 


script 


2  In  these  systems  Tel  is  used  for  its  scripting  advantages.  Users  are  expected  to  add 
Tel  code  to  tailor  the  system  for  their  purposes. 


Here  Tel  code  controls  hardware.  Many  of  these  systems  are  used  in  hardware 
1 4  development  where  engineers  do  Tel  scripting  in  order  to  create  tests  by  piecing 
together  operations  from  a  library. 


dist  9  These  are  distributors  of  Tcl/Tk  or  libraries. 


defunct  1 6  Systems  no  longer  having  a  discemable  Web  presence. 

Figure  4:  Type  Codes  and  Their  Meanings 

(“#”  is  the  number  of  systems  of  that  type.) 


There  are  no  similarities  between  this  user  interface  and  that  of  classic  Tcl/Tk  windows. 
Rather  than  a  collection  of  widgets  there  is  a  document  image.  Rather  than  static,  space- 
constrained  window  contents,  the  entire  document  scrolls.  Rather  than  buttons,  there  are 
links.  Rather  than  just  text,  information  is  augmented  with  images  and  icons,  such  as  the  stars 
for  the  movie  rating.  Rather  than  shades  of  blue,  the  full  rainbow  is  exploited.  Rather  than 
window  proliferation,  the  usual  result  of  an  action  is  to  replace  the  window  contents.  Rather 
than  a  succession  of  user  decisions,  the  information  flow  has  been  worked  out  so  that 
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common  operations  are  done  in  simple  fashion.  Rather  than  extensive  training,  there  is  NO 
training.  Not  all  is  perfect,  of  course;  the  system  is  expensive,  so  advertising  is  rampant. 

The  “Top  Ten”  list  offered  challenges  in  getting  acceptable  performance.  Two  architectures 
were  implemented,  deployed,  and  discarded  before  hitting  on  a  successful  approach.  The 
final  Movie  Guide  architecture  looks  like  this: 


k 


Switch 


Figure  5:  Digital  City  Movie  Guide  Architecture 


Each  user’s  page  request  is  distributed  by  a  switch  to  one  of  the  myriad  front-end  servers. 
These  communicate  via  a  “Proxy”  mechanism  that  serves  as  a  lightweight  process  running  a 
script;  in  this  case  the  script  accesses  a  “PLS”  database  of  movie  data.  This  database  is 
replicated  from  a  master  database  maintained  by  a  publisher  server  “Pub”  reading  from  a 
database.  As  each  front  end  gets  a  click  on  a  movie,  it  accumulates  tally  counts  and  sends 
them  to  pub.  In  turn,  pub  periodically  collates  this  data  and  sends  new  top  ten  lists  to  the  front 
ends. 


From  this  example,  we  see  that  AOLserver  has  nothing  in  common  with  systems  composed 
of  classic  Tcl/Tk  windows.  In  fact,  the  Tk  GUI  toolkit  is  used  only  marginally  to  provide 
some  operator  functionality.  Nor  is  the  software  architecture  that  of  a  classic  Tcl/Tk  window. 
Many  layers  are  involved  in  providing  service.  Moreover,  AOL  is  not  reluctant  to  rewrite  Tel 
procedures  into  other  languages  to  improve  performance.  Indeed,  Davidson  comments  that 
they  have  an  nstats  command  that  “returns  the  usage  counts  of  individual  [Tel]  commands 
[and  is]  a  great  way  to  look  for  fat  procedures  which  could  be  moved  to  C.” 
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6  Issues  in  Choosing  Architectures  for  SYS 


The  preceding  section  reviewed  a  number  of  commercial  systems  put  forth  as  examples 
illustrating  the  applicability  and  viability  of  Tcl/Tk.  Strikingly,  not  one  of  these  systems 
adopts  either  the  GUI  or  software  architecture  of  SYS.  The  Web  envt  and  Web  app  systems 
generate  Web  pages  instead  of  classic  Tcl/Tk  windows.  The  small  systems  do  generate  classic 
windows,  but  not  nearly  as  many  as  SYS.  The  remaining  systems  use  Tel  for  its  scripting 
capabilities;  users  are  expected  to  write  Tel  code  as  part  of  their  work. 

Since  the  case  has  not  been  made  that  Tcl/Tk  and  the  current  architectures  should  be  retained 
for  future  development  of  SYS,  it  is  appropriate  to  consider  alternatives.  This  section  does  so 
and  goes  on  to  explore  a  number  of  ancillary  factors  that  also  bear  upon  the  decisions  that 
must  be  made. 


6.1  Alternatives  for  the  User  Interface  Architecture 

SYS’ s  present  user  interface  architecture  is  classic  Tcl/Tk  windows.  The  major  alternative  is  to 
interact  with  the  user  by  presenting  Web  pages  through  a  browser.  Leaving  aside  for  now  the 
issue  of  generating  these  pages,  we  can  ask  here  whether  they  offer  advantages.  I  believe  they 
do: 

•  The  overall  effect  of  a  Web  page  is  that  of  reading  a  document.  Thanks  to  the  built-in 
tools  of  HTML,  the  document  can  have  fonts,  colors,  and  images  without  undue  effort 
on  the  developer’s  part.  Users  have  considerable  experience  in  perusing  Web 
documents.  They  are  accustomed  to  scrolling,  searching,  and  cut/paste  within  them. 
None  of  these  operations  is  as  intuitive  or  as  familiar  in  classic  Tcl/Tk  windows. 

•  Navigation  in  a  Web-based  version  of  SYS  can  easily  offer  more  options  than  those  of  a 
window  hierarchy.  For  instance,  browser  text  search  can  be  exploited  by  providing  a 
large  page  listing  all  available  SYS  reports.  To  find  one  a  user  could  scan  this  list  or 
interrogate  it  with  text  search.  Another  page  can  offer  the  present  hierarchy  of  menus. 
By  exploiting  free-text  format,  the  menu  options  can  have  much  more  descriptive  text 
than  the  current  buttons. 

•  The  distinction  between  buttons  and  links  deserves  comment.  Each  can,  of  course,  be 
used  to  emulate  the  other.  However,  the  tradition  with  buttons  is  to  place  them  at  a 
specific  location  with  a  cryptic  word  or  two  to  suggest  their  function.  Links,  in 
contrast,  are  usually  embedded  in  explanatory  text.  What’s  more,  links  are  often 
associated  with  pictures  to  make  their  meaning  even  clearer. 
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6.2  Alternatives  for  Software  Architecture 

The  critical  goal  of  a  software  architecture  for  SYS  is  to  isolate  changes  in  one  area  from  the 
other  areas  of  the  system.  To  this  end,  business  rules,  user  interface  operations,  and  database 
schemas  should  each  be  handled  in  distinct  portions  of  the  code.  Often  this  is  accomplished 
by  separating  the  code  in  “tiers”  with  a  layer  for  each  set  of  functionality.  A  complimentary 
mechanism  is  object-oriented  programming.  Each  entity — rule,  data  item,  or  user  interface 
artifact — is  represented  by  an  object.  The  code  implementing  a  class  of  objects  is  designed  so 
that  any  operation  that  changes  attributes  of  an  object  will  make  corresponding  changes  to 
other  objects  as  necessary  to  maintain  consistency. 

Tel  code  can  easily  by  stratified  into  tiers.  It  is  enough  to  define  the  layers  and  specify  how 
each  will  interact  with  the  others.  The  code  is  then  written  according  to  these  conventions.  In 
the  past,  Tel  was  intended  for  small  tasks  and  lacked  the  usual  constructs  that  support  object- 
oriented  programming.  Since  version  8.0,  the  Tel  core  has  been  augmented  with  such  support 
in  the  form  of  “[incr  Tel].”  That  capability  could  be  made  part  of  the  architecture  for  SYS’s 
future. 

If  Web  pages  are  chosen  as  the  user  interface  architecture,  that  does  not  mean  that  a  Web 
server  must  be  used.  Tel  could  be  used  to  create  the  pages;  it  is  a  general-purpose  language 
and  anything  can  be  coded.  However,  it  makes  more  sense  to  use  a  Web-server  environment 
since  many  of  the  necessary  tools  will  be  provided.  There  are  a  number  of  options: 

•  Choose  one  of  the  systems  in  the  web  envt  category  of  Table  1.  Perhaps  even 
AOLserver. 

•  Choose  J2EE  (Java  2  Enterprise  Edition).  This  is  an  open  framework  for  which  pieces 
have  been  constructed  by  a  number  of  vendors. 

•  Choose  .NET.  This  is  similar  to  J2EE,  but  does  have  the  disadvantage  of  further 
concentrating  the  marketplace. 

•  Choose  one  of  several  proprietary  Web  portal  frameworks. 

Whether  or  not  Tel  remains  the  development  language,  any  of  these  choices  will  result  in  a 
considerably  revised  software  architecture.  The  new  architecture  can  be  expected  to  be  more 
flexible  and  resilient. 


6.3  Development  Tools 

The  choice  of  development  language  must  be  influenced  by  the  support  for  that  language 
available  in  the  market  place.  A  support  environment  provides  code-generators,  program 
editors,  configuration  management,  debugging,  analysis,  and  other  tools  that  reduce 
development  efforts.  In  general,  the  number  and  quality  of  environments  available  depends 
on  the  popularity  of  the  language.  There  are  more  and  better  environments  for  C,  C++,  Java, 
and  Visual  Basic  than  there  are  for  Tel.  (But  that  would  not  justify  the  use  of  C  or  C++. 
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Neither  has  automatic  storage  management  and  both  are  notorious  for  harboring  difficult-to- 
find  errors.) 


6.4  User  Platform 

In  a  software  architecture  with  application  servers,  each  user’s  workstation  must  have 
appropriate  software  to  connect  to  the  server.  Installation  and  upkeep  of  this  software  can  be 
an  issue.  There  are  three  general  connection  types:  Web  browser,  X-windows  as  at  present,  or 
an  application-specific  interface  program.  Since  browsers  are  universal  on  workstations,  that 
option  minimizes  maintenance  effort.  X-windows  is  also  generic,  but  must  be  installed  and 
tailored  for  access  to  the  application  server.  Application-specific  programs  are  the  most 
problematic;  they  must  be  specifically  installed  on  any  workstation  that  needs  to  access  SYS 
and  they  will  usually  need  to  be  re-deployed  as  the  system  evolves. 

Like  most  organizations,  the  one  using  SYS  has  chosen  a  set  of  standard  hardware/software 
platforms  that  are  supported,  supplied  to  users,  and  expected  to  be  the  systems  they  use. 
Among  the  problems  are  these: 

•  The  standardization  process  may  delay  deployment  of  new  versions  of  commercial 
software.  When  new  SYS  versions  have  been  built  in  anticipation  of  the  new 
environment,  the  standardization  delay  will  defer  SYS  deployment.  The  new 
functionality  will  be  that  much  longer  in  reaching  the  users. 

•  In  emergencies,  users  may  want  to  use  non-standard  workstations.  These  will  have  to 
be  fitted  out  to  have  whichever  access  software  has  been  chosen. 

•  Non-standard  workstations  may  not  offer  the  same  level  of  security  as  is  offered  by  the 
standard  package. 

Altogether,  the  issue  of  server  connection  is  best  met  by  browser-based  delivery  of  SYS  to  the 
user.  However,  the  other  alternatives  are  not  bad  enough  that  the  choice  of  delivery  method 
should  depend  on  this  factor  alone. 


6.5  Scripting 

Many  of  the  commercial  systems  reviewed  expose  Tel  scripting  as  a  tool  for  users.  For  the 
ctler  and  script  categories,  this  is  a  primary  motivation  for  Tel.  For  instance,  engineers  using 
systems  in  the  ctler  category  will  create  numerous  scripts  to  test  each  new  product.  Few  of 
the  SYS  users,  however,  are  qualified  for  or  interested  in  writing  scripts  to  augment  or  modify 
the  system.  Indeed,  allowing  them  to  do  so  could  result  in  violation  of  the  business  rules 
incorporated  in  the  system  and  possible  corruption  of  the  database.  Thus  scripting,  a  key 
advantage  of  Tel,  is  not  a  factor  in  the  choice  of  architectures  for  SYS. 
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6.6  Development  Personnel 

The  reservoir  of  developers  for  Tcl/Tk  systems  is  small  and  relatively  stagnant.  Schools  are 
not  turning  out  developers  trained  in  Tcl/Tk,  so  they  are  harder  to  find  and  more  expensive 
when  found.  On  the  other  hand,  they  tend  to  be  more  experienced  and  introduce  somewhat 
fewer  bugs  than  recent  graduates.  Tcl/Tk  programmers,  being  more  mature  and  less  mobile, 
have  lower  turnover;  at  least  that  has  been  the  experience  of  the  SYS  project.  However,  they 
are  sometimes  passionate  about  their  chosen  tool  and  may  not  be  amenable  to  transfer  to 
sibling  projects  in  other  languages  should  funding  vagaries  so  dictate.  Current  and  anticipated 
availability  of  development  and  maintenance  personnel  must  be  a  factor  in  architectural 
decisions. 
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Conclusion 


The  basic  claim  questioned  in  this  note  is  that  Tcl/Tk  and  an  architecture  of  classic  Tcl/Tk 
windows  is  an  appropriate  path  for  the  future  of  SYS.  Examination  of  the  Web  site  lists 
offered  as  evidence  in  support  of  this  claim  showed  that  those  lists  are,  at  best,  irrelevant.  No 
projects  similar  to  SYS  appear.  In  fact,  projects  similar  to  SYS  generally  use  enterprise 
framework  tools  like  J2EE  and  .Net. 

Two  architectures  pervade  classic  Tcl/Tk  windows,  a  user  interface  architecture  and  an 
application  architecture.  Both  are  limited  to  small  systems  because  of  the  increasing 
complexity  that  arises  as  their  paradigms  are  extended  to  bigger  systems.  There  is  no  question 
that  the  current  SYS  implementation  is  working  and  can  continue  to  work.  It  should  probably 
be  retained  as  a  component  of  any  future  development.  However,  the  present  architecture 
should  not  be  permitted  to  dictate  the  architecture  of  extensions. 

Even  if  the  present  user  and  software  architectures  are  abandoned,  Tcl/Tk  could  still  be 
retained  as  the  development  environment.  AOLserver  would  be  one  model  that  could  be 
followed.  Adoption  of  this  model  should  not  be  made  lightly  or  without  considering  the  many 
factors  explored  above. 
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Appendix:  Commercial  Uses  of  Tcl/Tk 
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1 3.  ABSTRACT  (MAXIMUM  200  WORDS) 

The  Software  Engineering  Institute  (SEIsm)  was  called  on  recently  to  examine  a  system, 
hereafter  called  SYS,  written  entirely  in  the  Tool  Control  Language/Toolkit  (Tcl/Tk) 
language.  In  response  to  some  negative  comments  in  the  SEI’s  report,  the  developers 
presented  a  list  of  systems  purported  to  demonstrate  the  viability  of  Tcl/Tk  as  a 
development  tool.  A  review  of  the  67  listed  systems  found  that  Tcl/Tk  is  indeed  practical 
for  developing  large  systems. 

Small  systems  written  in  the  language  often  follow  a  paradigm  of  “classic  Tcl/Tk 
windows.”  SYS  embraced  this  approach  to  the  extent  of  involving  hundreds  of  windows. 
The  review  showed  that  no  other  large  system  written  in  Tcl/Tk  has  anywhere  near  as 
many  such  windows.  User  interviews  suggested  that  the  number  of  different  windows 
was  indeed  a  problem.  SYS  should  consider  an  alternative  design,  perhaps  a  Web- 
based  approach.  Some  design  criteria  are  described  at  the  end  of  the  report. 
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